home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / fred.arc / FRED.DOC next >
Encoding:
Text File  |  1986-04-25  |  12.7 KB  |  363 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                          FRED EDITOR REFERENCE V1.23
  7.  
  8.                          (c) 1983 by David N. Smith
  9.                              44 Ole Musket Lane
  10.                               Danbury, CT 06810
  11.                                22 August 1983
  12.  
  13.  
  14.  
  15.  
  16.      FRED  is the FRee EDitor.  It is distributed as  "User-Supported"
  17.      software which means that you do not have to pay for it.  You can
  18.      copy  it,  give  it away, or do anything else with it except sell
  19.      it.  If you find  that it is very useful, you are invited to make
  20.      a donation or contribution to the author of $20 to help reimburse
  21.      him for his time and effort and  to  encourage  him to write more
  22.      free software.
  23.  
  24.      FRED comes with no warranties of any kind; it is available AS IS.
  25.      The author would like  to  know  of  problems that users have but
  26.      makes no promise or guarantees that any  problem  will  be fixed.
  27.      There are no plans for extensions to FRED.
  28.  
  29.  
  30.  
  31.      ABOUT FRED
  32.  
  33.      FRED is a full screen editor for  the  IBM PC.  It displays files
  34.      up to 1500 lines long and with lines up to 254 characters long on
  35.      a monochrome display  or  80 column graphics display.  The screen
  36.      is a window onto the file.  The window can move  up,  down,  left
  37.      and right.  Lines  which  are  longer  than the screen are partly
  38.      displayed.  If you insert data, characters seem to be lost off of
  39.      the end of the line;  they  are  not  lost but are just no longer
  40.      displayed.  Move the  cursor  off  of the screen to the right and
  41.      they will reappear as the window moves.
  42.  
  43.      If  a file is too big to fit into memory, it complains  politely;
  44.      if  memory nears the limit while you are editing, FRED tells  you
  45.      and lets you continue editing but won't  let  you add more lines.
  46.      In general, it is forgiving; you can even remove the diskette  it
  47.      is reading from or writing to without  bombing it or loosing data
  48.      in memory but this is not recommended (nor guaranteed).
  49.  
  50.      It  updates  the  display buffer directly so that screen  updates
  51.      appear  instantaneous; it is fully possible to scroll  through  a
  52.      file at typamatic speeds.
  53.  
  54.      FRED is written in about 590 lines of compiled BASIC and about 30
  55.      lines of assembler.  Since its performance is horrid except  when
  56.      compiled, source is not distributed.
  57.  
  58.  
  59.                                    - 2 -
  60.  
  61.  
  62.      FRED is similar to the IBM Personal Editor; most of it's keys are
  63.      the  same  and  its  approach to handling the screen is about the
  64.      same.  I use the Personal  Editor;   FRED  was an experiment from
  65.      some  time ago which I had laid aside.  Several months of reading
  66.      the  dialogs  on  the IBM PC Special Interest Group on CompuServe
  67.      convinced me that there  are  many people out there who still use
  68.      EDLIN and who will never pay $100 for an editor.  Therefore I got
  69.      FRED  out  and  polished  it  up a bit to give away.  I hope that
  70.      people find it useful.
  71.  
  72.      The  documentation  is  somewhat sparse; there is no tutorial and
  73.      little else but a  list  of  keys.   I suspect that most PC users
  74.      won't have any trouble using it since most of  the  keys  do  the
  75.      "right" thing.
  76.  
  77.      If you want to try it immediately, remember that F1  puts  you in
  78.      command mode and displays a  list  of  the  commands and that F10
  79.      describes the other function keys; then just start trying things.
  80.  
  81.  
  82.  
  83.      FRED FILES
  84.  
  85.      The following files are a part of the FRED package.  According to
  86.      where you get FRED  you  may  get more or less of them.  Only the
  87.      first two are needed to run FRED.
  88.  
  89.           Filename      Contents
  90.           ------------  --------------------------------------------
  91.           FRED.DOC      A ready-to-print FRED document
  92.                         (what you are reading now)
  93.           FRED.EXE      The FRED Program
  94.           FREDDIE.EXE   The FRED Program but compiled to use
  95.                         BASRUN.EXE; it is thus much smaller.
  96.                         (BASRUN.EXE comes with the BASIC compiler.)
  97.           FRED.HEX      A transportable version of FRED.EXE
  98.                         found on some interactive systems.
  99.                         You run CVTHEX to make FRED.EXE.
  100.                         (CVTHEX is also on the interactive system.)
  101.           FRED.GET      A short note about how to get FRED
  102.                         found on some interactive systems.
  103.           FRED.SUM      A summary of FRED features.
  104.  
  105.  
  106.  
  107.                                    - 3 -
  108.  
  109.  
  110.      STARTING FRED
  111.  
  112.      Type FRED.   When FRED loads it will ask for the name of the file
  113.      to edit.   If  the  file cannot be found, it is assumed to be new
  114.      and an empty file with that name is edited.  It does not exist on
  115.      disk until you file it.
  116.  
  117.  
  118.  
  119.      FRED COMMANDS
  120.  
  121.      Commands  are  entered  only after pressing the F1 key.  Commands
  122.      may  be  typed  in   upper-   or   lowercase;  in  the  following
  123.      descriptions,  uppercase  is used for command names and lowercase
  124.      for operands.
  125.  
  126.      SAVE
  127.           Save  the  file  to  disk.   The  new  file  is  written  as
  128.           FREDFRED.TMP.  Then the old file is renamed FREDFRED.BAK and
  129.           FREDFRED.TMP   is  renamed  with  the  right   name.    Then
  130.           FREDFRED.BAK  is  erased.   This  process  assures that that
  131.           there is always one correct copy of the  file  on  the disk.
  132.           However, it  does  require  enough working space to hold the
  133.           largest file to be edited.
  134.  
  135.      QUIT (or 'Q')
  136.           Quit  editing.  If the file has been changed,  you  will  be
  137.           prompted for a 'y' before FRED really quits.
  138.  
  139.      /string/
  140.  
  141.      .string.
  142.           Locate the string between the slashes or dots.  The trailing
  143.           slash  or  dot  can  be  omitted unless trailing blanks  are
  144.           important.  The string can contain slashes or dots.
  145.  
  146.      NAME fileid
  147.           Give the file a new name.
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.      FRED KEYS
  155.  
  156.  
  157.      The following list defines the meaning  of  each key when in full
  158.      screen mode.  When the command  prompt  is  up, normal BASIC line
  159.      editing is in effect.
  160.  
  161.      Alt-d
  162.           Delete a marked area; see Alt-l for more information.
  163.  
  164.      Alt-j
  165.           Join the next line onto the current one at the end.
  166.  
  167.      Alt-l
  168.           Mark  the current line or extend a marked line.   The  first
  169.           Alt-l marks a line and displays it in  reverse  video.   The
  170.           second  marks  all  lines  from  the  first  one through the
  171.           second.   Further Alt-l keystrokes extend the marked area to
  172.           the current line (or shrink it from the nearest edge).
  173.  
  174.           Marked  areas  may  be copied or deleted.  See Alt-d, Alt-u,
  175.           and Alt-z.
  176.  
  177.      Alt-s
  178.           Split  the  current  line into two parts at the cursor.   At
  179.           column one this  adds  a new  lines  before the current one;
  180.           this is how you put a new line ahead of the first one.
  181.  
  182.      Alt-u
  183.           Unmark an area; see Alt-l.
  184.  
  185.      Alt-z
  186.           Copy a marked area to just after the current line.  A marked
  187.           area  cannot be moved into itself.  (The choice of Alt-z for
  188.           this function comes from the IBM Personal Editor.)
  189.  
  190.      Backspace
  191.           Backspace over and delete the previous character.
  192.  
  193.      Character keys, shifted or unshifted.
  194.           Enter  the character into the current line.   If  in  insert
  195.           mode, put it at the cursor position and slide the characters
  196.           under  and  to  the right of the cursor to the right.  If in
  197.           replace mode, replace the character under the cursor.
  198.  
  199.      Ctrl-End
  200.           Position the cursor on the  last  line of the file.  Keep it
  201.           in the same column.
  202.  
  203.  
  204.  
  205.                                    - 5 -
  206.  
  207.  
  208.      Ctrl-Home
  209.           Position the cursor on the top line of the file.  Keep it in
  210.           the same column
  211.  
  212.      Ctrl-Left
  213.           Move the cursor to the left 40 positions.
  214.  
  215.      Ctrl-Pg Dn
  216.           Position  the cursor at the bottom edge of the screen (or on
  217.           the last line of the file if encountered first).  The column
  218.           position is unchanged.
  219.  
  220.      Ctrl-Right
  221.           Move the cursor to the right 40 positions.
  222.  
  223.      Cursor keys (arrows on numeric keypad)
  224.           Move the cursor up, down,  left,  or right one position.  If
  225.           the cursor would move  off  of  the screen in a direction in
  226.           which  there  is  more data,  then  scroll  the  screen  one
  227.           character in that direction.
  228.  
  229.      Del
  230.           Delete the character under the cursor.
  231.  
  232.      End
  233.           Position the cursor at the end of current line.
  234.  
  235.      Enter key
  236.           Put a new line in the file  and  position  the cursor at the
  237.           front of it.  (Also see Alt-J.)
  238.  
  239.      F1
  240.           Enter  command  mode.  A list of  the  allowed  commands  is
  241.           displayed.
  242.  
  243.      F2
  244.           Repeat the most recent locate command (see the "/" command).
  245.  
  246.      F5
  247.           Clear  the  current line and position the cursor at the left
  248.           edge.
  249.  
  250.      F6
  251.           Clear the current line under and to the right of the cursor.
  252.  
  253.      F10
  254.           Display what the other function keys do.
  255.  
  256.  
  257.  
  258.                                    - 6 -
  259.  
  260.  
  261.      Home
  262.           Position the cursor in the first column  of both the current
  263.           file line and the screen.
  264.  
  265.      Ins
  266.           Toggle between insert  and  replace  modes.  The status line
  267.           describes which is in effect.
  268.  
  269.      Pg Dn
  270.           Scroll down 20 lines.
  271.  
  272.      Pg Up
  273.           Scroll up 20 lines.
  274.  
  275.      Shift-F4
  276.           Undo a change to the current line.  Once the cursor is moved
  277.           from the line the change cannot be undone with this key.
  278.  
  279.      Shift-F8
  280.           Delete the line at the cursor.  The cursor moves to the next
  281.           line in the file.
  282.  
  283.      Tab
  284.           Tab right to the beginning  of  the  next  word.  (Words are
  285.           groups of characters separated by blanks.)
  286.  
  287.  
  288.  
  289.                                    - 7 -
  290.  
  291.  
  292.      DISCLAIMER.
  293.  
  294.      In  no event will the Author be liable for any damages, including
  295.      any  lost   profits,   lost   savings   or  other  incidental  or
  296.      consequential  damages arising out of the use of or inability  to
  297.      use this program, even  if  the  Author  has  been advised of the
  298.      possibility of such damages, or for any claim by any other party.
  299.  
  300.  
  301.  
  302.      COPYING BY ORGANIZATIONS
  303.  
  304.      Clubs  and  other non-profit organizations are granted permission
  305.      by the author to freely copy these programs and documentation and
  306.      share it with their members, so long as:
  307.  
  308.      1.  No  price  is  charged  for  the  software  or documentation.
  309.          However,  a distribution  cost may be charged for the cost of
  310.          the diskette, so long as it is not more than $6 total.
  311.  
  312.      2.  Club members are  informed  of the user-supported concept and
  313.          encouraged to support it with their donations.
  314.  
  315.      3.  The program  or documentation are not modified in any way and
  316.          are distributed together.
  317.  
  318.  
  319.  
  320.      USER SUPPORTED SOFTWARE
  321.  
  322.      If you are using this program and find it to  be  of  value  your
  323.      contribution ($20 is suggested) will be appreciated.
  324.  
  325.         David N. Smith    44 Ole Musket Lane    Danbury, CT 06810
  326.  
  327.      Regardless of whether you make a contribution, you are encouraged
  328.      to copy and share this program with your friends.
  329.  
  330.      User-supported software is an experiment in distributing computer
  331.      programs, based on three beliefs:
  332.  
  333.      1.  That the value  and  utility  of software is best assessed by
  334.          the user on his/her own system.
  335.  
  336.      2.  That  the  creation of personal  computer  software  can  and
  337.          should be supported by the computing community.
  338.  
  339.      3.  That copying of programs  should  be  encouraged, rather than
  340.          restricted.
  341.  
  342.      Anyone may request a copy of a user-supported  program by sending
  343.      a blank, formatted disk to the author  of  the program along with
  344.  
  345.  
  346.  
  347.                                    - 8 -
  348.  
  349.  
  350.      an addressed, postage-paid return mailer.  A copy of the program,
  351.      with documentation on the disk, will be sent by return mail.
  352.  
  353.      Free distribution  of  software and voluntary payment for its use
  354.      eliminates advertising costs  and copy protection schemes.  Users
  355.      obtain quality software at reduced cost and can try it out before
  356.      buying.
  357.  
  358.      User-supported  software  was  conceived  by Andrew Fluegelman of
  359.      Headlands Press for PC-TALK.  He used the name FreeWare(tm).  Jim
  360.      Button, distributor  or  PC-FILE,  coined the term user-supported
  361.      software.
  362.  
  363.